home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / os2 / amos120.arj / AMOS.DOC next >
Text File  |  1994-02-05  |  33KB  |  701 lines

  1.  
  2.                AA      MM       MM    OOOO      SSSS
  3.               AAAA     MMMM   MMMM   OO  OO    SS  SS
  4.             AA    AA   MM MMMMM MM  OO    OO  SS    SS
  5.             AA    AA   MM  MMM  MM  OO    OO  SS
  6.             AA    AA   MM   M   MM  OO    OO   SSS
  7.             AAAAAAAA   MM   M   MM  OO    OO      SSS
  8.             AA    AA   MM       MM  OO    OO  SS    SS
  9.             AA    AA   MM       MM   OO  OO    SS  SS
  10.             AA    AA   MM       MM    OOOO      SSSS       v1.20
  11.  
  12.  
  13. Copenhagen, Denmark, 5. feb. 1994
  14.  
  15. About this document
  16. ───────────────────
  17.  
  18. This document is structured into several parts.
  19.   * A Brief Introduction
  20.   * A Word of Warning on the use of AMOS
  21.   * Benefits of Registering AMOS
  22.   * Information to Crackers wishing to look at AMOS
  23.   * Disclaimer and Legal Matters
  24.   * AMOS User's Guide
  25.   * Noteworthy Quirks in AMOS
  26.   * Future Plans for AMOS Releases
  27.   * Registration/Support Sites
  28.  
  29. Please refer to CONTENTS.TXT for a complete list of the files contained as
  30. a part of the AMOS archive.
  31.  
  32.  
  33. What is AMOS?
  34. ─────────────
  35.  
  36. Short version:
  37. --------------
  38. AMOS is a DOS-program, that enables you to read and write your HPFS-formatted
  39. harddisk drives from native DOS.
  40.  
  41. Long version:
  42. -------------
  43. AMOS is a DOS program for OS/2 users.  For the program to have any value, you
  44. need to run an OS/2 system with at least one drive formatted using the HPFS
  45. file system.
  46. The HPFS file system is IBM's shot at a file system, the purpose of which is
  47. to replace the FAT file system, which is outdated, slow and gives only a small
  48. degree of data security.
  49. In spite of all the good things about HPFS, it has at least one major drawback:
  50. HPFS drives cannot be read or written from "real" DOS.  Normally, this is no
  51. problem, since OS/2 takes care of all HPFS handling and maintenance.  But in
  52. some situations, it would be very nice indeed to have at least some degree of
  53. access to your HPFS-drives from real DOS...
  54.  
  55. For example:
  56.  * You wish to install a patch for OS/2.  This normally requires that you
  57.    reboot the machine, using the two first disks of OS/2.  Using AMOS, you
  58.    simply boot DOS, either using a boot disk or Dual Boot/Boot Manager, and
  59.    then copy the needed files.
  60.  * You have made an error in OS/2's CONFIG.SYS.  Sometimes, OS/2 simply halts
  61.    the system with the annoying message "Please correct the error and restart
  62.    the system".  Without AMOS, you once again have to go through the tedious
  63.    process of booting the two floppies, after which you discover that IBM has
  64.    forgotten to supply a text-mode editor with OS/2.
  65.  * Your youngest daughter unplugged the computer - and it takes half an hour
  66.    for OS/2 to CHKDSK!  Simply clear the dirty flag, and you are up and
  67.    running...
  68.  * You accidentialy deleted an important HPFS-partition using FDISK.  Even if
  69.    you immediately re-establish the partition, OS/2 cannot read data from the
  70.    partition.  Most of the time, AMOS can.
  71.  * You deleted a partition.  This caused the drive-letters to change, and
  72.    since these are hardcoded into your CONFIG.SYS file, OS/2 cannot boot.
  73.    Only option is to re-install, if OS/2 is located on HPFS.  With AMOS, you
  74.    simply correct the driveletters in CONFIG.SYS using the built-in editor.
  75.  * Something has gone terribly wrong, and you simply cannot make OS/2 boot.
  76.    All of your data reside on an inaccessible HPFS-drive, and you cannot get
  77.    them away from your HPFS-drive.  Use AMOS!
  78.  * You simply want to play the newest DOS-game, a game that of course uses
  79.    VCPI or some other weird DOS-extender that OS/2 doesn't like.  Just start
  80.    AMOS, and copy the desired files from your HPFS-drives to your FAT gaming
  81.    partition...
  82.  * You want to know more about your HPFS-drives.  You might want to investigate
  83.    EA's, harddisk fragmentation, file fragmentation, etc - and you don't want
  84.    to spend several hundred $ on commercial programs less powerful than AMOS.
  85.  * You want to CHKDSK your boot-drive.  Normally, you would have to boot
  86.    the install disks to do so - now, simply set the Dirty flag for the drive,
  87.    and boot OS/2.
  88.  
  89.  
  90. A Word of Warning - Read This Carefully!
  91. ────────────────────────────────────────
  92.  
  93. AMOS is *NOT* perfect.  What I have done in AMOS is to reverse engineer HPFS
  94. by looking at HPFS-drives, and deduct the format of HPFS-drives from that
  95. information.
  96.  
  97. Since this is the case, something has most certainly slipped my attention -
  98. something that may cause you loss of data.
  99.  
  100. Therefore, use AMOS for what it is made: An emergency tool.  AMOS can be
  101. invaluable on the day where you would have lost all of your data, but if you
  102. use it in a production environment, use it with great care.
  103.  
  104. Please refer to the section "Quirks in AMOS", as well as your DOS manual,
  105. for safe operation.
  106.  
  107.  
  108. Benefits of registering
  109. ───────────────────────
  110.  
  111. The unregistered version of AMOS can read your HPFS-drives, but can not make
  112. any changes on them.  By registering, you get access to write functions for
  113. HPFS-drives as well.
  114. Most important: when you register, you can EDIT your CONFIG.SYS, even if it
  115. is located on a HPFS-drive.  And of course you can clear the Dirt Flag on your
  116. HPFS drives as well!
  117. Further, the unregistered version has a delay of 10 seconds when you start it
  118. up.  In the registered version, this delay is removed.
  119.  
  120. Last, but not least, registering makes me keep the spirits high.  If nobody
  121. registers, development of AMOS will of course cease...
  122.  
  123.  
  124. Information to crackers
  125. ───────────────────────
  126.  
  127. Most, if not all shareware utilities on the market today, are being "cracked"
  128. by some wise guys who do not wish to pay for their software.  This section
  129. is devoted to this kind of people:
  130. * Do NOT try to patch AMOS - it's unique protection scheme makes patching
  131.   impossible, and might endanger data on your hard drives.
  132. * Do NOT try to alter AMOS.EXE in any way; AMOS will probably detect this, and
  133.   abort with an error message.
  134. * Do NOT distribute any altered versions of AMOS.  When an unsuspecting user
  135.   tries to register an altered version, AMOS refuses to register.  If you
  136.   have only a cracked version of AMOS, you can always get the newest version
  137.   by download from the BBS, or by file requesting AMOS from the below
  138.   mentioned systems.
  139. ! Some wise guy cracked an earlier version of AMOS.  He only succeeded in
  140.   removing the delay from the startup-sequence, and fortunately no harm has
  141.   come from his attempt (As far as I know).  I do, however, strongly advice
  142.   against use of any such cracked copies of AMOS.  After all, AMOS accesses
  143.   your harddisk at the lowest level - one single byte of code changed by
  144.   an incompetent (or unlucky!) cracker might spoil it!  Register instead ;)
  145.  
  146.  
  147. Disclaimer and legal matters
  148. ────────────────────────────
  149.  
  150. The AMOS software and documentation is subject to the following licensing
  151. terms and conditions.
  152.  
  153. * AMOS is supplied as is. The author disclaims all warranties,
  154.   expressed or implied, including, without limitation, the warranties
  155.   of merchantability and of fitness for any purpose. The author
  156.   assumes no liability for damages, direct or consequential, which may
  157.   result from the use of the AMOS software.
  158.  
  159. * AMOS is distributed as a "shareware program" and is provided at
  160.   no charge to the user for evaluation for a period not extending 30
  161.   days, after which You are required to register. Feel free to share
  162.   it with your friends, but please do not give it away altered or as
  163.   part of another system. The essence of "user-supported" software is
  164.   to provide personal computer users with quality software without
  165.   high prices, and yet to provide incentive for programmers to
  166.   continue to develop new products.
  167.  
  168. * The distribution archive is to be considered an evaluation copy only.
  169.   If you continue to use AMOS after a trial period of 30 days, please
  170.   register.
  171.  
  172. * The AMOS distribution package, all programs, the documentation
  173.   and support files are copyrighted 1993-94 by Allan Mertner. All
  174.   rights are reserved. You may copy this package for backup purposes.
  175.   You may also copy and share unmodified copies of the whole
  176.   distribution package, providing that the copyright notice is
  177.   reproduced and included on all copies.
  178.  
  179. * You may not sell the product for a fee and/or distribute the product
  180.   along with other products without written permission, nor may you
  181.   modify or remove the Copyright Notices from the programs or the
  182.   documentation files. User clubs, if they are NOT commercial, are
  183.   allowed to ask a small amount of money for distribution and storage
  184.   when they want to share this package amongst their members.
  185.  
  186. * It is expressively forbidden to modify, adapt, translate, reverse
  187.   engineer, decompile and/or disassemble the software in the AMOS
  188.   package. Patching the medium at places that carry the software is
  189.   seen as a program change and is also forbidden.
  190.  
  191. * The registered software is licensed to run in conjunction with one
  192.   user and one PC only.
  193.  
  194. * Commercial installations are required to pay the commercial registration
  195.   fee for AMOS.  Please refer to Register.Doc.
  196.  
  197.  
  198. AMOS user's guide
  199. ─────────────────
  200.  
  201.   Introduction
  202.   ------------
  203.  
  204.   Basically, AMOS is a command shell like the one you know from DOS or OS/2.
  205.   When you first start it, you get a command prompt that looks like the OS/2
  206.   prompt, and should look something like this:
  207.  
  208.   C:>AMOS [Enter]
  209.     (AMOS Reads a lot of information)
  210.   [C:\]_
  211.  
  212.   Batch command feature
  213.   ---------------------
  214.  
  215.   Invoking AMOS with a command as parameter, and optionally a preceding /C,
  216.   makes AMOS invoke that command before returning either to the command line
  217.   or DOS.
  218.   Example 1:
  219.     The DOS command
  220.       AMOS Copy f:\txt\*.doc c:\temp
  221.     starts AMOS, which then in turn executes the specified COPY command
  222.     before awaiting further user-input.
  223.  
  224.   Example 2:
  225.     The DOS command
  226.       AMOS /C Dir f:\temp\*.wk3
  227.     starts AMOS, executes the DIR command showing all *.wk3-files on f:\temp,
  228.     and returns to DOS.
  229.  
  230.  
  231.   Using AMOS
  232.   ----------
  233.   Sometime in the future, it is my plan to make AMOS a device driver, which
  234.   simply mounts your HPFS-drives for use with DOS.  Actually, work on the
  235.   device driver is progressing pretty well...
  236.  
  237.   Do NOT try to make any write operations using AMOS in an OS/2 DOS box.  OS/2
  238.   does not permit direct sector writes from DOS-boxes (Reports "Unknown
  239.   function", which I find rather cute).  If you do try, AMOS will kindly
  240.   remind you that writes in DOS-boxes is not possible.
  241.   All other functions do perform very well in DOS-boxes, though.
  242.  
  243.   For now, just use your normal DOS and OS/2 commands.  DIR works. COPY, DEL
  244.   and TYPE do as well.  With OS/2 wildcards.  Even EDIT works, given that the
  245.   file you wish to edit is no larger than 30k (I made this primarily for
  246.   CONFIG.SYS-editing).  Try it out.  If in doubt, try it anyway :-)
  247.  
  248.  
  249.   AMOS Command Line Use
  250.   ---------------------
  251.  
  252.   The command line in AMOS offers about the same capabilities as does DOS'
  253.   DOSKEY.  You can enter commands, and execute them by pressing [Enter] as
  254.   usual.  AMOS stores the last 2048 bytes of commands in a command buffer.
  255.  
  256.   By pressing the [Up] arrow, the commands of the buffer are read and
  257.   displayed, and can be executed as usual.
  258.  
  259.   If you want to locate a specific command from the buffer, write some of the
  260.   desired command, and press F8.  AMOS then searches backwards in the buffer,
  261.   until a command matching the entered command is found.  Pressing F8 again
  262.   locates the next command in the sequence, etc.
  263.  
  264.   For a list of the 20 last commands in the buffer, press F7.
  265.  
  266.   When you exit AMOS, the command buffer is saved to disc in the file AMOS.SAV.
  267.   When next started, AMOS reloads the command buffer, and you don't have to
  268.   enter all of your commands fra scratch again :-)
  269.  
  270.   Example, beginning with an empty buffer:
  271.     On screen                           User input
  272.     C:>                                 AMOS [Enter]
  273.       (AMOS starts up)
  274.     [C:\]                               DIR E:\TXT [Enter]
  275.       (Listing of files in E:\TXT)
  276.     [C:\]                               CD TEST\DLL [Enter]
  277.     [C:\TEST\DLL]                       CD \TEXT [Enter]
  278.     AMOS Error 1: The path \TEXT does not exist.
  279.     [C:\TEST\DLL]                       [Up Arrow]
  280.     [C:\TEST\DLL]CD \TEXT               (correct to CD TEXT, [Enter])
  281.     [C:\TEST\DLL\TEXT]                  DIR [F8]
  282.     [C:\TEST\DLL\TEXT]DIR E:\TXT        [Enter to accept command]
  283.       (Listing of files in E:\TXT)
  284.     [C:\TEST\DLL\TEXT]                  CD [F8]
  285.     [C:\TEST\DLL\TEXT]CD TEST\DLL       [F8]
  286.     [C:\TEST\DLL\TEXT]CD \TEXT          [Enter to accept command]
  287.     [C:\TEXT]                           [F7]
  288.       1: CD \TEXT
  289.       2: DIR E:\TXT
  290.       3: CD TEXT
  291.       4: CD \TEXT
  292.       5: CD TEST\DLL
  293.       6: DIR E:\TXT
  294.     [C:\TEXT]                           EXIT [Enter]
  295.       (AMOS exits, saving command buffer)
  296.     C:>
  297.  
  298.  
  299.   AMOS Command Summary
  300.   --------------------
  301.  
  302. Syntax          Description
  303. ADDEA Arg EAName EAContents
  304.                 Adds a type STRING Extended Attribute to one or more files
  305.                 as specified in Arg.
  306.                 This can be useful for file descriptions, even though OS/2
  307.                 doesn't do much to support EA's.
  308.                 Example:
  309.                   ADDEA * TestEA Hello There!  Adds an EA named TestEA to
  310.                                                all files in the current dir.
  311.                                                Content of the EA will be
  312.                                                "Hello There!".
  313.  
  314. CD <Arg>        Change Directory.  Changes the current directory to Arg, if
  315.                 this is a valid directory.  If not, AMOS will issue a cryptic
  316.                 error message.
  317.                 If you do not specify an argument, AMOS will tell you what
  318.                 the current directory is.
  319.                 Example: CD \TEST            changes to the \TEST dir
  320.                          CD ..\TEST
  321.                          CD F:               Show current dir on F:
  322.  
  323. CLS             Clears the screen
  324.  
  325. COPY <A1 A2>    Copies the file(s) A1 to the directory A2.  It is possible to
  326.                 copy more than one file using wildcards, but it is NOT
  327.                 possible to copy to new filenames.  With COPY, the /n-switch
  328.                 is valid, and reverses the file-selection.
  329.                 Example: COPY *.EXE C:\TEST  copies all EXE-files to C:\TEST
  330.                          COPY *.TXT C:\ /n   copies all but TXT-files to C:\
  331.                          COPY F:*            copies all files on F: to the
  332.                                              current drive and directory
  333.  
  334. DATE            Shows current date, and lets you edit it.
  335.  
  336. DIR <Arg>       Displays a listing of files and directories.  As in OS/2, you
  337.                 can specify a directory and/or wildcards as argument.  DIR
  338.                 accepts some switches as well, some of which are unique to
  339.                 AMOS:
  340.                 /s  lists all subdirectories as well
  341.                 /n  reverses the file-selection
  342.                 /p  pauses the listing when the screen is full
  343.                 /d  shows directories only
  344.                 /f  show fragmentation information (Both FAT and HPFS-volumes)
  345.                     Fragmentation occurs, when a file is not located in
  346.                     contiguous sectors on the hard disk, and the number
  347.                     shown is the number of sector-runs a particular file or
  348.                     directory occupies.
  349.                 Example: DIR *.EXE      shows all EXE-files in current dir
  350.                          DIR *.EXE /n   shows all but EXE-files
  351.                          DIR /d /n      shows all files, and no directories
  352.                          DIR /f         shows all files, including fragmen-
  353.                                         tation information
  354. DIRTY <Arg> [ON | OFF]
  355.                 If run with only a drive as argument, the status of the
  356.                 dirty flag for that drive is displayed.  Using the ON or OFF
  357.                 options resets/sets the dirty flag.  Drives having the dirty
  358.                 flag set are CHKDSK'ed by OS/2 at boot time, if they are
  359.                 named in the AUTOCHECK option of either HPFS or FAT in the
  360.                 CONFIG.SYS file.
  361.                 Resetting the dirty flag is useful, when OS/2 crashes, or you
  362.                 accidentially press the reset button.  You can then reset the
  363.                 dirty flag for all drives except your boot-drive, and boot
  364.                 OS/2.  You are then up and running, and can CHKDSK the rest
  365.                 of your drives manually, if you think there might be
  366.                 allocation errors on them.
  367.                 Use this feature with care - there *is* a reason why the
  368.                 dirty flag cannot normally be reset from DOS :-)
  369.                 Example: DIRTY E:          Shows status of dirty flag for E:
  370.                          DIRTY E: OFF      Resets the dirty flag for E:
  371.  
  372.  
  373. DEL <Arg>       Deletes files specified as argument.  Wildcards valid.  Please
  374.                 note, that AMOS asks for *NO* confirmation, even if you write
  375.                 "DEL *"!
  376.                 If you write DEL name, where name is a directory, all files in
  377.                 that directory will be erased.  No asking.
  378.                 You can use /n with DEL to reverse file selections.
  379.                 Example: DEL *.EXE        Remove all EXE-files
  380.                          DEL C:\*.EXE /n  Remove all but EXE-files on C:\
  381.                          DEL E:\OS2       Remove the file E:\OS2.  If E:\OS2
  382.                                           is a directory, remove ALL files
  383.                                           in that directory.
  384.  
  385. EA <Arg> [/p]   Shows Extended Attributes defined for file(s) specified as
  386.                 Arg.  The listing includes the names and types of all EA's
  387.                 defined for the file/directory, together with the value of
  388.                 the EA.  If the EA is long, only the first bytes are shown.
  389.                 Under OS/2, the command works on HPFS drives only, since
  390.                 FAT EA's are stored in the file "EA DATA. SF".  OS/2 locks
  391.                 this file for both reads and writes.
  392.                 If you specify the /p-option, AMOS prompts for a key every
  393.                 time the screen is full.
  394.                 Example: EA E:\*          Shows a list of all files and dirs
  395.                                           having associated EA's, like this:
  396. Entry Icons :
  397.  .ICONPOS    [Binary] 47 02 FF 7F 00 00 FF 7F 00 00 00 15  [573 not shown]
  398.  .CLASSINFO  [Binary] DC 00 90 00 00 00 CB 00 00 00 57 50  [210 not shown]
  399.  .LONGNAME   [String] Icons
  400.  .ICON       [Icon  ] F2 03 42 41 5C 00 00 00 00 00 00 00  [1000 not shown]
  401. Entry Nowhere :
  402.  .CLASSINFO  [Binary] CC 00 80 02 00 00 BB 00 00 00 57 50  [194 not shown]
  403.  .LONGNAME   [String] Nowhere
  404. Entry OS2KRNL :
  405.  .APPTYPE    [Binary] 04 00 00 00 10 40
  406.  .TYPE       [String] Executable
  407.  
  408.                 As can be seen from the above example, long EA's are not
  409.                 displayed in their entirety.  The number following the first
  410.                 few bytes of the EA refers to the number of bytes not shown.
  411.  
  412. EDIT <Arg>      Starts the internal textfile-editor on the file specified as
  413.                 argument.  The editor is a simple fullscreen editor, with only
  414.                 the most basic of editing functions - enough for CONFIG.SYS.
  415.                 It is not possible to create a new file using EDIT - you can
  416.                 only edit existing files.
  417.                 Editor keys:
  418.                 ESC          Exits the editor.
  419.                 Cursor keys  Moves the cursor around the screen :-)
  420.                 PgUp         Advance cursor one page
  421.                 PgDn         One page back
  422.                 Home         Go to start of line
  423.                 End          Go to end of line
  424.                 Ctrl-PgUp    Goes to top of file
  425.                 Ctrl-PgDn    Goes to end of file
  426.                 Ctrl-Left    Word left
  427.                 Ctrl-Right   Word right
  428.  
  429.                 When you press ESC to exit the editor, you will be asked if
  430.                 you want to save the changes (y), discard them (n), or return
  431.                 to the editor (ESC).
  432.  
  433. EXIT            Exits from AMOS to DOS, saving the command buffer.
  434.  
  435. FREE <D:> <Lvl> Shows a freespace map of the current drive.  Using this
  436.                 feature, you can get an overview of the level of freespace
  437.                 fragmentation on the drive.
  438.                 This feature also works for FAT drives.
  439.                 The first argument is the desired drive-letter; the second is
  440.                 an inverse magnification factor M between 0 and 10.
  441.                 When using an M-factor of 0, one character in the map
  442.                 represents 8 sectors on the disk, when M=1, one character
  443.                 equals 16 sectors, etc.  When M=10, information on 8192
  444.                 sectors are represented in one character.
  445.                 If you supply no parameter, AMOS will prompt you for a
  446.                 magnification factor.
  447.                 Example: FREE D: 4
  448.                          FREE 8
  449. [E:\]free D: 8
  450.     Free space map of drive D:
  451.     One character represents 2048 sectors
  452.     "█" represents all used, "·" all free...
  453.    ┌────────────────────────────────────────────────────────────────┐
  454.    │▒▒████▒▒█▒▒▒█▒█▒█░▒░▒···▒▒▒█████▒█▒▒▒███▒██▒█▒▒▒█▒█▒▒▒▒▒▒▒████▒▒│
  455.    │▒▒▒▒▒█▒▒▒███▒█▒▒▒▒░·░···▒██████▒▒▒······▒······░██████▒▒░······░│
  456.    │░·······░······░░·······░······░░·······░······░░·······░······░│
  457.    │░·······░······░░·······░······░░·······░                       │
  458.    └────────────────────────────────────────────────────────────────┘
  459.  
  460.                 In the example output shown above, a magnification of 8 is
  461.                 chosen - else the example would have taken up a bit more of
  462.                 space.  The dotted (.) spaces represent 2048 consecutive free
  463.                 sectors, and the filled spaces (█) represent blocks of 2048
  464.                 sectors all used.  The ones in between shows that some of the
  465.                 sectors are occupied.
  466.  
  467. HELP            Shows a short description of all available commands.
  468.  
  469. MAP             Shows a listing of all partitions.  The list includes the
  470.                 type of each drive, current directory, total drive space and
  471.                 free space.  For HPFS drives, the time of the last CHKDSK
  472.                 operation is noted as well.
  473.                 Last, but not least, the status of the Dirty flag is
  474.                 displayed for each drive.
  475.                 Example: MAP on my machine gives the following output:
  476.  
  477.      MAP : Partition information on 5 partitions on 1 physical harddrives
  478.  
  479.      Drive           Size/kB    Free/kB   Type      Last CHKDSK /F   Dirty
  480.      C:\             118,668     77,086   BIGDOS    n/a for FAT      YES
  481.      D:\TEST           8,001      7,621   HPFS      Never            YES
  482.      E:\OS2\DLL      160,618     31,242   HPFS       4-02-94  17.18  YES
  483.      F:\           1,349,428     53,001   HPFS       3-02-94   0.03  NO
  484.      G:\BINKLEY      208,813     40,596   HPFS       4-02-94  16.56  YES
  485.  
  486.                 AMOS says "Never" to Last CHKDSK /F date, if the drive has
  487.                 not been CHKDSK'ed since it was formatted HPFS.
  488.  
  489. MD <Arg>        Makes a new directory.  The opration will not succeed, if
  490.                 there is already a file of the same name in the directory
  491.                 where you want to create a new directory.
  492.                 Example: MD C:\TEST       Makes the dir TEST on C:\
  493.                          MD HELLO         Makes the dir HELLO in the
  494.                                           current directory.
  495.  
  496. RD <Arg>        Removes the directory <Arg>, if <Arg> is a valid, empty
  497.                 directory.  If not, AMOS tries to explain what went wrong.
  498.                 Example: RD C:\DOS        Removes C:\DOS
  499.                          RD TEST          Removes TEST
  500.                          RD OS2*          Error message: Wildcards not allowed.
  501.  
  502. REMEA <File EA> Removes one or more EA's from one or more files/directories.
  503.                 Handy for cleaning up EA's that you no longer want.  No
  504.                 wildcard parsing is performed - you must either specify one
  505.                 EA-name, or * for all EA's.
  506.                 Example: REMEA * .ICON     Removes .ICON EA from all files
  507.                          REMEA * *         Removes all EA's from all files
  508.                          REMEA *.TXT .ICON Removes .ICON EA from all .TXT-files
  509.  
  510. TOUCH <Arg>     Sets the file date and time for all files and directories
  511.                 matched by <Arg> to current time.  This command works with
  512.                 HPFS drives only.
  513.                 Switches to use with TOUCH:
  514.                 /n  Reverses the file-selection
  515.                 /d  Selects directories only
  516.  
  517. TREE <Arg>      Shows a list of all directories from and below <Arg>. Abort
  518.                 by pressing <ESC>.
  519.                 Example:
  520.                 [C:\OS2\DLL]tree
  521.                   139 files: C:\OS2\DLL
  522.                     2 files: C:\OS2\DLL\DISPLAY
  523.                     3 files: C:\OS2\DLL\IBMNULL
  524.                     5 files: C:\OS2\DLL\HP
  525.                    44 files: C:\OS2\DLL\HP\PCL
  526.                     3 files: C:\OS2\DLL\HP\PCL\LASERJET
  527.                     4 files: C:\OS2\DLL\PLOTTERS
  528.  
  529.                 Total files in listed directories:
  530.                      200 file(s)  10,546,247 bytes used
  531.  
  532. TIME            Shows current time in an editable format.  Allows you to
  533.                 change system time...
  534.  
  535. TYPE <Arg> </p> Types all files matching <Arg> to the screen.  Use with
  536.                 textfiles only, since all other files look weird on
  537.                 the display.  Abort the listing by pressing <ESC>.
  538.                 Example: TYPE C:\*CON* makes AMOS type both CONFIG.SYS,
  539.                 CONFIG.BAK and TESTCON.EXE on drive C:\.
  540.                 If you specify the /p-option, the display pauses every time
  541.                 the screen is full.
  542.  
  543. VER             Shows the current version of AMOS.
  544.  
  545. WIPE            Wipes all free sectors on the disk, writing "HPFSWipe" in all
  546.                 unoccupied bytes.  I use this primarily for test reasons, but
  547.                 is quite useful for data security.
  548.                 WIPE functions only on HPFS drives, and only in the registered
  549.                 version.
  550.                 IF you use WIPE, be SURE that you make a CHKDSK /F before you
  551.                 do so!  AMOS can NOT handle allocation errors when wiping.
  552.  
  553. <Drive>:        Changes to a new drive.  If the drive is not either a floppy
  554.                 drive or a harddisk drive, AMOS will try to give you a
  555.                 decent error message.
  556.                 Example: F:          Change to F:
  557.                          I:          AMOS error: Drive I: is not a valid
  558.                                      harddisk drive.
  559.  
  560.  
  561. Quirks in AMOS
  562. ──────────────
  563.  
  564. * Freespace
  565.   On FAT drives, AMOS asks DOS how much space is free, so I suppose that no
  566.   errors should occur here.  On HPFS-drives, I have been unable to find out
  567.   how much available space there is.
  568.   However, I do have a method of finding out which sectors are occupied and
  569.   which are not, so I simply count these.  Since OS/2 reserves some of this
  570.   space for directory information and the like, this gives a number a bit
  571.   higher than the one OS/2 reports.
  572.  
  573. * Addressing directories
  574.   An ambiguity can occur, when addressing directories.  Given a directory
  575.   TEST on drive E:, how would you interpret the following commands:
  576.    1 : DIR TEST
  577.    2 : DIR T*ST
  578.    3 : REMEA TEST *
  579.    4 : REMEA T*ST *
  580.    5 : REMEA TEST\* *
  581.    6 : DEL TEST
  582.  
  583.   Since TEST is a directory, AMOS (as does DOS) assumes that the commands
  584.   1, 3, 5 and 6 are directed against the content of the TEST directory.
  585.   Thus, 6 would delete all files in TEST, 3 would remove all Extended
  586.   Attributes associated with files in TEST, and 1 would show all files in
  587.   TEST.
  588.   However, when a wildcard is specified, the directory itself is meant, since
  589.   you cannot address more than one directory using one command.  Command 4
  590.   would remove all EA's associated with the directory TEST itself (as well
  591.   as those associated with other wildcard matches, like TOAST), and 2 would
  592.   show a list of all these directories and files.
  593.   Be careful out there!
  594.  
  595. * Many files
  596.   Problems may occur when reading or writing huge directories - by huge I mean
  597.   dir's with more than 4000 files!  This is a gray area, since it seems that
  598.   OS/2 also has problems when handling such structures...
  599.  
  600. * Low on diskspace
  601.   Beware of low diskspace!  Since AMOS reports every single free byte on the
  602.   disk, COPYing files that only just fit may result in an error.  HPFS uses
  603.   heaps of information on every file, meaning that each file has a slight
  604.   overhead in disk space consumption.  COPYing a 4 byte file typically
  605.   uses 1024 bytes or even more!
  606.  
  607. * Legal characters in file/dir-names
  608.   No checking of valid filenames is performed.  Thus, you could create a
  609.   directory named "/!' !..," and AMOS wouldn't complain.
  610.   OS/2 will, though - be sure of that!
  611.   Example:
  612.   With AMOS, you can create a directory named "HI OS2" by typing
  613.   MD HI OS2
  614.   on the command line.  This even works on a FAT drive!  OS/2 has no
  615.   objections to this, but DOS has!  This directory cannot be accessed
  616.   from DOS, nor can it be accessed from an OS/2 DOS box.
  617.  
  618. * Trouble accessing files with spaces in the name
  619.   Setting "'s around filenames in is not supported in AMOS.  Thus, you
  620.   cannot COPY such files as easily as under OS/2.  It _is_ possible, though:
  621.   COPY F:HELLO MATE
  622.   copies the file "HELLO MATE" from drive F: to the current drive.
  623.  
  624. * Attribute support
  625.   AMOS does not respect the DOS or HPFS attributes "System", "Hidden", and
  626.   "Read Only".  No confirmation is asked for when deleting/modifying files
  627.   with one or more of these attributes set, nor are Hidden files treated in
  628.   any special way.
  629.  
  630.  
  631. Future releases of AMOS
  632. ───────────────────────
  633.  
  634. At the moment, I have the following plans for AMOS releases.  A total lack of
  635. registrations probably cancels the plan, though.
  636.  
  637. Users having registered AMOS v1.x are entitled to free upgrades.  A small
  638. handling fee is charged for sending you a new registration-file.
  639.  
  640.  
  641. 1st Quarter 1994: AMOS v1.x:
  642.         These will be more bugfix-releases, with more extras added.  Look
  643.         forward for a sector-editor, an EA-editor, and maybe even a
  644.         FAT <-> HPFS converter.
  645.  
  646.  
  647. 3rd Quarter, 1994: AMOS v2.x:
  648.         AMOS in a device driver/TSR version.  This version will (hopefully)
  649.         enable you to mount HPFS-drives as "normal" drives, using them
  650.         as normal drives.
  651.         Since this actually is not as simple as it may sound, the release
  652.         date is a ...  guess!
  653.  
  654.         AMOS v2.x will cost at least the same as does AMOS v1.x.  Users
  655.         having registered AMOS v1.x will be charged an upgrade fee for
  656.         AMOS v2.x.
  657.  
  658.  
  659. Support site information
  660. ─────────────────────────────
  661.  
  662. Allan Mertner
  663. Enghavevej 20A, 2tv
  664. DK-1674 Copenhagen V
  665. Denmark
  666.  
  667. I can be contacted through the following networks and node numbers:
  668.  FidoNet    : 2:234/107
  669.               2:234/156
  670.               2:234/157
  671.               2:234/158
  672.  
  673.  OS2Net     : 81:445/14
  674.  
  675.  CryptoNet  : 70:450/0
  676.  
  677.  CompuServe : 100327,2035
  678.               AMOS registration ID : 1808
  679.  
  680.  Rainbow BBS:
  681.  BBS Line 1 : +45-3325-7322 (ZyXEL 19k2 / v32bis)
  682.  BBS Line 2 : +45-3325-7321 (v32bis)
  683.  BBS Line 3 : +45-3325-7320 (HST 16k8 / v22bis)
  684.  BBS Line 4 : +45-3325-7319 (ZyXEL 19k2 / v32bis)
  685.  
  686.  
  687. Acknowledgements
  688. ────────────────
  689.  
  690. First of all, I'd like to say a big thanks to my brother Morten, without whose
  691. harddisk and patience AMOS would never have been released.  If you think that
  692. you are unlucky because your harddisk always goes down on you, take a moment
  693. to think of Morten.
  694.  
  695. Every time I have developed a new fancy feature in AMOS, particularly in the
  696. early staged of the project, Morten volunteered for testing.  Mostly, the
  697. results were fatal, and a reinstallation of OS/2 was necessary.  I don't
  698. really know why he's still in - but he's still my beta tester :-)
  699.  
  700. Thanks!
  701.